From: Evan Goode <mail@evangoo.de>
Date: Mon, 19 May 2025 21:08:11 +0000 (+0000)
Subject: man: Document `ostree admin unlock --transient`
X-Git-Tag: archive/raspbian/2025.7-2+rpi1^2^2~6^2~4^2~31^2
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=fe9a8b0ef9194c11552696f3d6f54a4340e181f0;p=ostree.git

man: Document `ostree admin unlock --transient`

Signed-off-by: Evan Goode <mail@evangoo.de>
---

diff --git a/man/ostree-admin-unlock.xml b/man/ostree-admin-unlock.xml
index d499419a..836c77db 100644
--- a/man/ostree-admin-unlock.xml
+++ b/man/ostree-admin-unlock.xml
@@ -83,6 +83,17 @@ License along with this library. If not, see <https://www.gnu.org/licenses/>.
 		you likely want for security hotfixes).
                 </para></listitem>
             </varlistentry>
+            <varlistentry>
+                <term><option>--transient</option></term>
+
+                <listitem><para>If this option is provided, the
+                overlay filesystem will be mounted read-only. It can
+                still be affected by remounting it as read/write in a
+                new mount namespace. For example:</para>
+                <programlisting>ostree admin unlock --transient
+unshare -m -- sh -c 'mount --options-source=disable -o remount,rw /usr &amp;&amp; touch /usr/myfile'</programlisting>
+                </listitem>
+            </varlistentry>
         </variablelist>
     </refsect1>
 </refentry>